主题
MCP 排障
MCP 连不上、用不了——先看状态点告诉你的失败阶段，再对号入座。九成问题五分钟内能自己解决。
第一步：看状态与失败阶段
MCP 列表里状态点开，失败信息带阶段名——它直接告诉你断在哪一环：
| 失败阶段 | 意思 | 常见原因与解法 |
|---|---|---|
| resolve（解析） | 启动命令 / 包名找不到 | 命令拼错了；npx 类需要 Node 环境（跑一遍工具链与环境初始化） |
| spawn（启动） | 进程起不来 | 可执行文件路径不对；Windows 下 .cmd 脚本被安全策略拦——看错误信息里的命令，修正配置 |
| initialize（握手） | 起来了但握手失败 | 版本不兼容（MCP 服务太老 / 太新）；服务端自身报错——看服务方文档 |
| tools（列工具） | 握手成功但拿不到工具清单 | 服务端配置缺工具段；网络代理截断了流 |
| probe（探测） | 探针验证失败 | 服务半死状态——先停用再启用重启该 MCP |
需要认证（needs_auth）
OAuth 类 MCP（连 Notion、钉钉等云服务）首次要授权：
- 状态显示需要认证 → 点授权 → 跳浏览器登录 → 回来自动完成
- 授权过期会再弹——重新走一遍即可
连上了但 AI 没用上
按顺序查三样：
- 状态是 🟢 吗——红了先按上表修
- 授权给当前智能体了吗——管理页该 MCP 的授权清单里，勾上你正在用的智能体
- 需求匹配吗——对话里点名一次：「用××MCP 查一下××」
其它常见症状
| 症状 | 解法 |
|---|---|
| 时好时坏（间歇失败） | 多半是网络 / 代理不稳；或该 MCP 服务自身不稳——停用重启用；关键任务别依赖不稳定的源 |
| 用着用着断了 | 断线会自动重连；重连不上看状态点的最新阶段 |
| 装了两个同类 MCP 冲突 | 留一个——同类工具两个源容易混，停用不用的那个 |
| 公司内网 MCP 连不上 | 确认内网可达（VPN 连了吗）；代理设置是否放行该地址 |
| 重启产品后全红了 | 环境快照问题——跑一遍工具链初始化（会统一重启 MCP 环境） |
修不好时
把失败状态里的错误信息直接发给对话：
text
数据库 MCP 连不上，错误是 spawn 阶段：command not found: mysql-mcp-server，
帮我修一下。它按错误信息排查——改配置、补环境、重启服务，能自动修的直接修好。
延伸阅读
- 接入与使用 MCP 服务：接入与日常使用
- 工具链与环境：MCP 运行环境的初始化
- 出问题了怎么办：总排障入口